home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_794 / P_PLAYER / P_PLAYER.TXT < prev    next >
Text File  |  1998-03-14  |  35KB  |  796 lines
  1.  
  2.  
  3.  
  4.                        Anleitung zu "The Piano-Player"
  5.                     © 1993,1994,1995 by Bogi-Productions
  6.                                   FAIRWARE
  7.  
  8.                                 Peter Bogner
  9.                                Humbserstr. 10
  10.                                 D-90763 Fürth
  11.                E-Mail: prbogner@cip.informatik.uni-erlangen.de
  12.  
  13.                 23. März 1994 - Letzte Änderung: 3. März 1995
  14.  
  15.  
  16.  
  17.  
  18. Inhaltsverzeichnis
  19. ==================
  20.  
  21. 1) Einleitung
  22. 2) Bedienung des Programmes
  23.   2.1) Starten des Programms
  24.   2.2) Bildschirmaufbau
  25.     2.2.1) Key-Fenster
  26.     2.2.2) Tempo-Fenster
  27.   2.3) Mausbedienung des Tempofensters
  28.   2.4) Tastaturbedienung des Tempofensters
  29.   2.5) Menüpunkte
  30.     2.5.1) The Piano-Player/Copyright
  31.     2.5.2) Datei/Lade SMF
  32.     2.5.3) Datei/Ende
  33.     2.5.4) Bearbeiten/Abspielen
  34.     2.5.5) Bearbeiten/Analyse
  35.     2.5.6) Einstellungen/Key-Monitor
  36.     2.5.7) Einstellungen/Benutze SMF-Tempo
  37.     2.5.8) Einstellungen/Keyboard öffnen bzw. schließen
  38.     2.5.9) Hilfe-Menü
  39.   2.6) Key-Fenster neu zeichnen
  40. 3) Funktionsumfang
  41.   3.1) Key-Monitor
  42.   3.2) Laden von Standard-MIDI-Files - Einschränkungen
  43.   3.3) Abspielen eines Standard-MIDI-Files
  44.     3.3.1) Abspielen abbrechen
  45.     3.3.2) Weitere Einschränkungen bei Standard-MIDI-FILES
  46.     3.3.3) Timingverhalten beim Abspielen
  47.   3.4) Sonstige Funktionen
  48.     3.4.1) Erweiterter Klaviaturumfang
  49.     3.4.2) 'Toppen' des Key-Fensters
  50. 4) Anforderungen
  51.   4.1) Speicherbedarf
  52.   4.2) Rechnertypen
  53.   4.3) Auflösung
  54. 5) Bekannte Probleme
  55.   5.1) Abbrechen bei langsamen Standard-MIDI-Files
  56.   5.2) Probleme mit dem Key-Monitor
  57.   5.3) Fehlende MIDI-THRU-Funktion
  58. 6) Sonstiges
  59.   6.1) Werbung - Andere MIDI-Programme von mir
  60.   6.2) Credits
  61.   6.3) Aufruf an Benutzer des Programmes
  62. 7) Nutzungs-, Verbreitungs- und sonstige Bestimmungen
  63.   7.1) Nutzungsbestimmungen
  64.   7.2) Vertrieb
  65.   7.3) Haftung
  66.   7.4) Updates
  67.   7.5) Warenzeichen
  68. 8) Schlußwort
  69. 9) Literatur
  70.  
  71.  
  72. 1) Einleitung
  73. =============
  74.  
  75. Huch,  sollte denn wirklich jemand mein Programm P_PLAYER.PRG  erhalten  haben
  76. und nun doch tatsächlich diese Anleitung lesen? Also letzteres kann ich  abso-
  77. lut nicht glauben,  denn Anleitungen liest doch wirklich  kein  Computer-User,
  78. oder?
  79.  
  80. Nun denn,  falls es wirklich jemanden interessiert,  zu was mein Programm denn
  81. nützlich sein kann folgt nun eine kurze Erklärung.
  82.  
  83.  - P_PLAYER.PRG ist ein sehr einfacher Standard MIDI File Player,  der es  er-
  84.    laubt, die abzuspielenden Noten auf einem Bildschirmkeyboard anzuzeigen.
  85.  
  86.    Zu was soll denn so was gut sein? - Ganz einfach:  Da  meine  pianistischen
  87.    Fähigkeiten sehr zu wünschen übrig lassen (noch stark untertrieben!)  hatte
  88.    ich einfach Mal Lust, einen Klavierspieler mal beim Spielen zuzusehen, z.B.
  89.    Billy Joel "Root Beer Rag", George Dukes "Sweet Lucy" oder "Get out of your
  90.    lazy bed" von Matt Bianco.  Nun habe ich natürlich keinen Piano-Man zuhause
  91.    im Schrank herumstehen,  der  mir  die  Sachen  mal  schnell  spielt,  also
  92.    entstand dieses Programm,  mit dem  Pianosongs  abgespielt  werden  können.
  93.    Dafür geht natürlich auch jedes  anderes  Sequenzerprogramm  (z.B.  Cubase,
  94.    Notator Logic,  u.a.), und das sogar viel besser! Aber die gespielten Noten
  95.    auf einer Klaviatur anzeigen zu lassen,  das können schon sehr viel weniger
  96.    (z.B.  BigBoss - kennt das jemand?), also mußte ich selbst ran, um ein Pro-
  97.    gramm zu schreiben, das das kann, und das Ergebnis liegt nun vor.
  98.  
  99.  - P_PLAYER.PRG besitzt eine Key-Monitor Funktion,  d.h.  die an  einem  ange-
  100.    schlossene MIDI-Instrument  gespielten  Noten  werden  an  dem  Bildschirm-
  101.    keyboard angezeigt.
  102.  
  103.  - P_PLAYER.PRG ist voll in GEM eingebunden und müßte mit allen Atari-Rechnern
  104.    (für die Oberlehrer unter den Lesern,  die nur darauf  lauern,  hier  etwas
  105.    falsches zu lesen:  gemeint sind  Atari-Rechner  der  68000er-Familie,  und
  106.    nicht etwa Dosen, oder etwa Uralt-Rechner dieses Herstellers) laufen.
  107.  
  108.  
  109. 2) Bedienung des Programmes
  110. ===========================
  111.  
  112. 2.1) Starten des Programms
  113. --------------------------
  114.  
  115. Nach dem Starten des Programmes erscheint eine Fileselektorbox,  mit  dem  ein
  116. Standard-MIDI-File ausgewählt werden kann (Dateiendung: .MID).
  117.  
  118. Wird ein MID-File ausgewählt und der "OK"-Button betätigt,  wird versucht, die
  119. angegebene Datei zu laden.  Falls es sich um ein SMF (SMF steht für  Standard-
  120. MIDI-File -  ein  Standard  zum  austauschen  von  MIDI-Musikstücken  zwischen
  121. verschiedenen Sequenzern bzw. Sequenzerprogrammen!) mit Format 0 oder Format 1
  122. (darf bis zu 32 Tracks enthalten) handelt und die Dateilänge nicht größer  als
  123. 131072 Bytes (= 128 kByte) ist wird die Datei geladen,  andernfalls  erscheint
  124. jeweils eine Meldung.  (Wird der Name "*.MID",  der als  Voreinstellung  dient
  125. übernommen, wird die erste im aktuell angewählten Verzeichnis ".MID"-Datei ge-
  126. laden, sofern eine solche vorhanden ist.)
  127.  
  128. Falls beim Starten des Programms eine Datei (mit Pfadangabe?) übergeben  wird,
  129. wird versucht, die übergebene Datei zu laden. (Falls mehrere Dateien übergeben
  130. werden,  wird nur die erste übergebene Datei  geladen).  Eine  Dateiauswahlbox
  131. erscheint in diesem Fall nicht.
  132.  
  133. 2.2) Bildschirmaufbau
  134. ---------------------
  135.  
  136. Nachdem das Programm gestartet wurde und evtl.  ein SMF geladen werden konnte,
  137. sollten zwei Fenster auf dem Bildschirm erscheinen.
  138.  
  139. 2.2.1) Key-Fenster
  140. ..................
  141.  
  142. In dem sich am oberen Bildschirmrand befindlichen Fenster wird eine  61-Tasten
  143. umfassende Klaviatur dargestellt (nachfolgend Key-Fenster genannt!).  Auf die-
  144. ser Klaviatur können die gespielten Noten angezeigt werden.
  145.  
  146. Dieses Fenster kann beliebig verschoben und auch geschlossen  werden.  In  der
  147. Infozeile des Fensters wird entweder der Name des geladenen SMF, der Titel des
  148. SMF (sofern ein solcher im SMF enthalten ist) oder die Meldung,  das kein  SMF
  149. geladen ist angezeigt.  Falls dieses Fenster beim Starten des Programms  nicht
  150. geöffnet werden kann,  erscheint eine Fehlermeldung, das Programm wird dennoch
  151. fortgesetzt,  mit der Einschränkung, daß alle vom Key-Fenster abhängigen Funk-
  152. tionen nicht durchgeführt werden können.
  153.  
  154. 2.2.2) Tempo-Fenster
  155. ....................
  156.  
  157. Im zweiten dargestellten  Fenster  ist  eine  Dialogbox  gezeichnet,  die  zum
  158. einstellen einer Tempoangabe dient (nachfolgend Tempo-Fenster genannt!).
  159.  
  160. Dieses Fenster kann nur innerhalb des Bildschirmes verschoben  und  nicht  ge-
  161. schlossen werden.  Falls dieses Fenster beim  Starten  nicht  geöffnet  werden
  162. konnte, wird das Programm mach einer Fehlermeldung abgebrochen.
  163.  
  164. 2.3) Mausbedienung des Tempofensters
  165. ------------------------------------
  166.  
  167.  - Über den Slider kann das Tempo im Bereich von Viertel =  20  -  300  einge-
  168.    stellt werden.
  169.  
  170.  - Ein Mausklick auf die Pfeile links bzw.  rechts verringert bzw.  erhöht das
  171.    Tempo um einen Schritt.
  172.  
  173.  - Ein Mausklick auf  das  Parentobjekt  erhöht/verringert  das  Tempo  um  10
  174.    Schritte.
  175.  
  176.  - Bei gedrückt gehaltener Sondertaste (SHIFT oder  ALTERNATE)  und  Mausklick
  177.    auf Parentobjekt erhöht/verringert sich das Tempo um 20.
  178.  
  179.  - Ein Mausklick auf Tempofeld ermöglicht bei  gedrückt  gehaltener  Maustaste
  180.    das direkte Einstellen des Tempos.
  181.  
  182. 2.4) Tastaturbedienung des Tempofensters
  183. ----------------------------------------
  184.  
  185.  - Über die Tastenkombination CONTROL-T kann das Tempo-Fenster getoppt werden.
  186.  
  187.  - '.' holt Tempoinformation aus SMF und trägt  dieses  in  das  Tempo-Fenster
  188.    ein.  Ist keine Tempoinformation in SMF enthalten,  wird der der  Tempowert
  189.    "Viertel = 120" eingetragen.
  190.  
  191. Die folgenden Tastenkommandos funktionieren nur,  wenn das  Tempo-Fenster  das
  192. oberste Fenster ist:
  193.  
  194.  - Über die Tasten '+',  '-',  '(',  ')',  '/',  '*' kann das Tempo im  Tempo-
  195.    fenster verändert werden:
  196.  
  197.     - '+' erhöht das Tempo um 1,  '-' verringert das Tempo um 1.
  198.  
  199.     - '(' erhöht das Tempo um 10, ')' verringert das Tempo um 10.
  200.  
  201.     - '/' erhöht das Tempo um 40, '*' verringert das Tempo um 40.
  202.  
  203.  - Wird zusätzlich eine Sondertaste (LSHIFT,  RSHIFT,  ALTERNATE) gedrückt ge-
  204.    halten,  während eine der Tasten '+',  '-', '(', ')', '/' oder '*' betätigt
  205.    wird, gelten folgende Tastenbelegungen ('Turbomodus'):
  206.  
  207.     - '+' erhöht das Tempo um 10, '-' verringert das Tempo um 10.
  208.  
  209.     - '(' erhöht das Tempo um 20, ')' verringert das Tempo um 20.
  210.  
  211.     - '/' stellt das minimale Tempo ein (Viertel = 20).
  212.  
  213.     - '*' stellt das maximale Tempo ein (Viertel = 300).
  214.  
  215. Das jeweilig eingestellte Tempo wirkt sich erst auf die Abspielfunktion aus.
  216.  
  217. 2.5) Menüpunkte
  218. ---------------
  219.  
  220. 2.5.1) The Piano-Player/Copyright
  221. .................................
  222.  
  223. Über den Menüeintrag "The Piano-Player/Copyright" bzw.  der  Tastenkombination
  224. CONTROL-I kann die Copyright-Meldung des Programms  aufgerufen  werden.  (Dies
  225. ist übrigens meine Lieblingsfunktion, weil ich so gerne meinen Namen in meinen
  226. Programmen lese!!!)
  227.  
  228. 2.5.2) Datei/Lade SMF
  229. .....................
  230.  
  231. Über den Menüpunkt "Datei/Lade SMF"  bzw.  den  Tastenkombinationen  CONTROL-O
  232. oder CONTROL-L kann über eine Dateiauswahlbox ein SMF ausgewählt  und  geladen
  233. werden.
  234.  
  235. (Dieser Menüpunkt wird beim Starten des Programmes automatisch aufgerufen,  so
  236. daß i.d.R. bereits ein SMF geladen ist. Somit gelten auch die oben angegebenen
  237. Einschränkungen bzgl.  der einzuladenden SMFs.  Auf die  Einschränkungen  wird
  238. später noch näher eingegangen.)
  239.  
  240. 2.5.3) Datei/Ende
  241. .................
  242.  
  243. Über den Menüeintrag "Datei/Beenden" bzw.  der Tastenkombination CONTROL-Q ist
  244. die wohl unwichtigste Programmfunktion zu erreichen.  Damit kann  man  nämlich
  245. das Programm wieder beenden,  aber ich weiß nicht,  wieso das Programm  jemals
  246. wieder verlassen werden sollte.
  247.  
  248. Wird dieser Menüpunkt dennoch ausgewählt erscheint eine Alertbox, in der nach-
  249. gefragt wird, ob das Programm wirklich verlassen werden soll.
  250.  
  251. 2.5.4) Bearbeiten/Abspielen
  252. ...........................
  253.  
  254. Über den Menüpunkt "Bearbeiten/Abspielen" bzw. der Tastenkombination CONTROL-P
  255. kann ein eingeladenes SMF abgespielt werden.
  256.  
  257. Um allen Mißverständnissen aus dem Weg zu gehen: Die MIDI-Daten gehen über die
  258. MIDI-OUT-Buchse des Computers an einen hoffentlich angeschlossenen MIDI-Klang-
  259. erzeuger (Keyboard,  Synthesizer,  Expander etc.), werden von diesem empfangen
  260. und unter Ausnutzung des jeweiligen Klangerzeugungssystem des jeweiligen Gerä-
  261. tes in hörbare Töne umgewandelt.  Eine Klang-Ausgabe am Lautsprecher des Moni-
  262. tors bzw.  über die Stereo- ausgänge der STE's oder Falcon ist nicht  möglich,
  263. ebenso ist es zwecklos,  an die MIDI-Buchsen des ST's einen (Audio-)Verstärker
  264. anzuschließen (auch wenn die 5-pol.  DIN-Buchsen gerade dazu einladen)  um  zu
  265. einem hörbaren Klangergebnis (vielleicht auch Klangerlebnis?) zu kommen!
  266.  
  267. 2.5.5) Bearbeiten/Analyse
  268. .........................
  269.  
  270. Über den Menüpunkt "Bearbeiten/Analyse" soll in einer späteren Programmversion
  271. das geladene SMF in Klartext,  d.h.  aufgeschlüsselt nach den einzelnen Noten,
  272. Controllerbefehlen,  Tempoänderungen etc.  in einem Textfenster angezeigt wer-
  273. den. Momentan ist dieser Menüpunkt nicht anwählbar.
  274.  
  275. Übrigens beinhaltet das Programm  SMF_LOAD.PRG  diese  noch  nicht  eingebaute
  276. Analyse-Funktion. Allerdings werden bei diesem Programm die Textausgaben nicht
  277. in ein Textfenster getätigt, sondern erscheinen auf dem "normalen" Bildschirm.
  278.  
  279. 2.5.6) Einstellungen/Key-Monitor
  280. ................................
  281.  
  282. Über den  Menüpunkt  "Einstellungen/Key-Monitor"  bzw.  der  Tastenkombination
  283. CONTROL-M kann der Key-Monitor an,  bzw. abgeschaltet werden. Beim Starten des
  284. Programms ist der Key-Monitor immer  eingeschaltet.  Ob  allerdings  die  Key-
  285. Monitor-Funktion wirklich aktiv wird  ist  vom  Key-Fenster  abhängig  -  mehr
  286. darüber im Abschnitt über den Key-Monitor.
  287.  
  288. 2.5.7) Einstellungen/Benutze SMF-Tempo
  289. ......................................
  290.  
  291. Über den Menüpunkt "Einstellungen/Benutze SMF-Tempo" bzw.  der  Tastenkombina-
  292. tion CONTROL-B kann eingestellt werden,  ob beim Abspielen das Tempo  aus  dem
  293. geladenen SMF verwendet werden soll (sofern Tempoangaben in diesem  vorhanden)
  294. - Häkchen gesetzt,  oder ob mit dem über das Tempofenster  eingestellte  Tempo
  295. abgespielt werden soll - Häkchen in Menüeintrag nicht gesetzt.
  296.  
  297. Beim Laden eines SMFs wird unabhängig von dieser Einstellung das Tempo aus dem
  298. SMF (sofern Tempoangabe  vorhanden)  in  das  Tempo-Fenster  eingetragen.  Die
  299. Einstellung dieser Option wirkt sich erst beim Abspielen  aus,  ist  sie  ein-
  300. geschaltet,  wird unabhängig von dem im Tempo-Fenster eingestellten Tempo  das
  301. im SMF angegebene Tempo  verwendet,  ansonsten  das  im  Tempo-Fenster  einge-
  302. stellte. Beim Starten des Programmes ist die immer Option ausgeschaltet.
  303.  
  304. 2.5.8) Einstellungen/Keyboard öffnen bzw. schließen
  305. .....................................................
  306.  
  307. Über den Menüpunkt "Einstellungen/Keyboard schließen"  bzw. der Tastenkombina-
  308. tion CONTROL-K kann das Key-Fenster geöffnet,  bzw. wieder geschlossen werden.
  309. Beim Starten des Programmes ist das Key-Fenster immer  geöffnet,  sofern  noch
  310. ein Fensterhandle frei ist.
  311.  
  312. Wenn das Key-Fenster geschlossen wurde und wieder geöffnet werden  soll,  dann
  313. erscheint es immer am oberen Bildschirmrand unterhalb der Menüzeile,  d.h. die
  314. aktuelle Fensterposition wird nicht gespeichert.
  315.  
  316. 2.5.9) Hilfe-Menü
  317. .................
  318.  
  319. Über den Menütitel "Hilfe" mit den Menüpunkten "Programm",  "Datei", "Bearbei-
  320. ten",  "Einstellungen", "Sonstiges" und "Anforderungen" können Hilfstexte auf-
  321. gerufen werden.
  322.  
  323. Falls noch ein Fensterhandle frei ist werden diese Texte in einem Fenster dar-
  324. gestellt,  ansonsten erscheinen normale Dialogboxen.  Es kann  immer  nur  ein
  325. Hilfstext angezeigt werden.
  326.  
  327. Das  Copyright-/bzw. Hilfefenster  wird  bei  jedem  Aufruf   immer   in   die
  328. Bildschirmmitte zentriert gezeichnet - kann aber beliebig auf  dem  Bildschirm
  329. verschoben werden.  Das Fenster kann über das Close-Feld,  den OK-Button  oder
  330. der RETURN-Taste geschlossen werden.
  331.  
  332. 2.6) Key-Fenster neu zeichnen
  333. -----------------------------
  334.  
  335. Mit der Taste UNDO kann der Inhalt des Key-Fenster neu gezeichnet werden,  so-
  336. fern das Key-Fenster das oberste Fenster ist. Dies ist sinnvoll, da es vorkom-
  337. men kann, daß u.U. gezeichnete Noten nicht zurückgesetzt werden.
  338.  
  339.  
  340. 3) Funktionsumfang
  341. ==================
  342.  
  343. 3.1) Key-Monitor
  344. ----------------
  345.  
  346. Mit dem Key-Monitor können die an einem  über  MIDI  angeschlossenen  Keyboard
  347. gedrückten Tasten am Bildschirmkeyboard  (im  Key-Fenster)  angezeigt  werden.
  348. Wenn dem angeschlossenen Keyboard eine Taste  gedrückt  wird,  wird  die  ent-
  349. sprechende Taste  im  Key-Fenster  gekennzeichnet  (mit  einem  kreisähnlichen
  350. 'Fleck' bei Verwendung von NVDI,  bzw.  ein etwas rautenähnliches ohne  NVDI).
  351. Wird die Taste wieder losgelassen, verschwindet auch die Kennzeichnung wieder.
  352.  
  353. Beim Starten des Programms ist der Key-Monitor aktiv,  sofern das Key- Fenster
  354. geöffnet werden konnte (siehe unter sonstiges).
  355.  
  356. Die Key-Monitor-Funktion ist abhängig von der Einstellung  im  Menü  "Einstel-
  357. lungen/Key-Monitor",  sowie von der Darstellung des Key-Fensters (erstens  muß
  358. das Key-Fenster geöffnet sein,  zweitens muß das Key-Fenster das oberste, d.h.
  359. das aktive Fenster sein).
  360.  
  361. Überleitung zum SMF-Player:
  362.  
  363. So schön es auch ist,  die am MIDI-Keyboard gespielten Töne am Monitor mit an-
  364. zusehen,  wird dieses auf die Dauer doch etwas langweilig (mir ging es  zumin-
  365. dest so). Da meine klavierspieltechnischen Fähigkeiten doch sehr eingeschränkt
  366. sind,  ich aber schon seit längerem z.B.  das Stück "Root Beer Rag" von  Billy
  367. Joel  zumindest  mal  'gespielt  sehen  wollte',   wurde  ein  sehr  einfacher
  368. SMF-Player eingebaut.
  369.  
  370. 3.2) Laden von Standard-MIDI-Files - Einschränkungen
  371. ----------------------------------------------------
  372.  
  373.  - Auch auf die Gehar hin,  daß ich mich wiederhole:  Das Programm verarbeitet
  374.    (nun!) SMF-Format 0 und 1 (bei letzterem bis zu 32 Tracks).
  375.  
  376.  - Die maximale Dateilänge für einzulesende SMF's beträgt 128kB! Längere  SMFs
  377.    werden vom Programm nicht eingelesen!
  378.  
  379.  - Die SMFs dürfen (und sollen  sogar)  Tempoinformationen  enthalten.  Leider
  380.    speichern allerdings nicht alle Sequenzer diese beim Format 0 mit ab.  Dies
  381.    stellt aber im wesentlichen kein Problem dar,  da  sich  Tempoinformationen
  382.    manuell einfügen lassen - wie man solche z.B.  einfügen kann steht  in  der
  383.    Datei  "insert.txt".   (Vorsicht:   "insert.txt"   enthält   nichtdruckbare
  384.    Zeichen!)
  385.  
  386. 3.3) Abspielen eines Standard-MIDI-Files
  387. ----------------------------------------
  388.  
  389. Abhängig davon, ob das Key-Fenster geöffnet ist werden beim Abspielen die über
  390. MIDI ausgegebenen NOTE-On's und  NOTE-Off's  im  Key-Fenster  angezeigt.  Dies
  391. funktioniert allerdings nur sinnvoll, wenn das Key-Fenster das oberste Fenster
  392. ist.  Ist ein anderes Fenster gerade aktiv,  wird untersucht,  ob sich  dieses
  393. Fenster mit dem Key-Fenster überlappt.  Wenn keine Überlappung  vorliegt  wird
  394. das Keyfenster 'getoppt' - die Abspielfunktion kann nun die Noten anzeigen.
  395.  
  396. Busy-Playing:
  397.  
  398. Während ein Song abgespielt werden soll, bei dem die Noten auf dem Bildschirm-
  399. keyboard angezeigt werden sollen (und können, d.h. keine Überlappung mit ande-
  400. ren Fensters) sind sämtliche anderen Aktivitäten des Computers gesperrt  (mit-
  401. tels wind_update(BEG_UPDATE), wind_update(END_UPDATE)-Klammerung. Sollen (oder
  402. können) die Noten nicht angezeigt werden,  ist es möglich unter  Multitasking-
  403. umgebungen mit anderen Applikationen weiterzuarbeiten.
  404.  
  405. 3.3.1) Abspielen abbrechen
  406. ..........................
  407.  
  408. Mit der Tastenkombination 'CTRL-C' kann die Abspielfunktion  ganz  abgebrochen
  409. werden.
  410.  
  411. <Hinweis:> Unter Mag!X werden die Tastendrücke seltsamerweise 'verschluckt' --
  412. hier sollte die jeweilige Taste etwas länger gedrückt gehalten werden, bis der
  413. gewünschte Effekt eingetreten ist!
  414.  
  415. 3.3.2) Weitere Einschränkungen bei Standard-MIDI-FILES
  416. ......................................................
  417.  
  418. Es ist beim Abspielen mit aktiviertem Key-Fenster nur  das  Abspielen  einfach
  419. gehaltener SMFs sinnvoll möglich. Mit 'einfach' meine ich Klavierberabeitungen
  420. (für solche wurde das Programm  schließlich  urspünglich  auch  geschrieben  -
  421. daher der Name "The Piano-Player"),  die nicht allzu  viele  Noten  enthalten.
  422. komplette Arrangements incl.  Drum, Bass und Akkordbegleitung scheitern i.d.R.
  423. daran,  daß alle Noten(-marken) am Bildschirmkeyboard angezeigt werden  müssen
  424. (läuft über VDI-Funktionen, und die benötigen nun mal auch etwas Zeit.).
  425.  
  426. Am besten geeignet ist das Programm zum Abspielen von Klavierbearbeitungen wie
  427. sie z.B. in der Zeitschrift Keyboards veröffentlicht werden.
  428.  
  429. Das Abspielen komplexerer SMFs ist  aber  ohne  die  Anzeige-Funktion  dennoch
  430. (d.h. in den meisten Fällen) möglich.
  431.  
  432. 3.3.3) Timingverhalten beim Abspielen
  433. .....................................
  434.  
  435.  - Das SMF wird gleichzeitig ausgewertet  und  abgespielt,  d.h.  während  der
  436.    Abspielfunktion ist  der  Rechner  damit  beschäftigt,  die  MIDI-Daten  zu
  437.    entschlüsseln und auszugeben.  Je nach Anzahl der gleichzeitig abzuspielen-
  438.    den MIDI-Daten kann dabei der Rechner etwas zu lange  brauchen,  die  Folge
  439.    ist,  daß Timingschwankungen entstehen. (Es wäre natürlich möglich, das SMF
  440.    vorab zu entschlüsseln,  aber auf die von mir gewählte Weise ging es leich-
  441.    ter - vielleicht gibt's ja demnächst eine neuere Version des Programms,  in
  442.    dem dies dann verbessert wird.)
  443.  
  444.  - Die Graphik-Ausgaben werden über das VDI gemacht (wie es auch sein sollte).
  445.    Dies hat allerdings den Nebeneffekt,  daß die  MIDI-DATEN  erst  ausgegeben
  446.    werden,  wenn die entsprechenden Grafikausgaben alle fertig sind,  und  das
  447.    dauert manchmal bei schnellen Stücken zu lange.
  448.  
  449.    In diesem Fall sollte,  falls das Programm als SMF-Player eingesetzt werden
  450.    soll,  die Key-Fenster-Funktion abgeschaltet werden (d.h.  das  Key-Fenster
  451.    geschlossen werden).
  452.  
  453. 3.4) Sonstige Funktionen
  454. ------------------------
  455.  
  456. 3.4.1) Erweiterter Klaviaturumfang
  457. ..................................
  458.  
  459. Um auf dem gezeichneten 61-Tasten-Keyboard einen größeren Notenumfang darstel-
  460. len zu können,  werden die Notennummern < 36 in  der  untersten  dargestellten
  461. Oktave und die Notennummern > 97 in der obersten dargestellten Oktave  jeweils
  462. oberhalb der normalen Markierungen gezeichnet.
  463.  
  464. 3.4.2) 'Toppen' des Key-Fensters
  465. ................................
  466.  
  467. War vor Betätigen der Abspielfunktion das Tempo-Fenster  das  oberste  Fenster
  468. und konnte das Key-Fenster getoppt werden (weil keine Überlappung mit  anderen
  469. applikationseigenen Fenstern festgestellt werden konnte) wird  nach  Beendigen
  470. der Abspielfunktion das Tempofenster wieder getoppt.
  471.  
  472.  
  473. 4) Anforderungen
  474. ================
  475.  
  476. 4.1) Speicherbedarf
  477. -------------------
  478.  
  479. Das Programm legt beim Starten einen statischen Buffer der Größe 128kB an,  in
  480. dem SMFs eingeladen werden. Dieser Buffer kann während des Programmlaufs nicht
  481. vergrößert bzw. verkleinert werden (was erwartet man denn sonst von einer sta-
  482. tischen Speicherverwaltung?).  Falls beim  Starten  für  diesen  Buffer  nicht
  483. genügend Speicher zur Verfügung steht erscheint  eine  Fehlermeldung  und  das
  484. Programm bricht ab.
  485.  
  486. Das Programm sollte aber dennoch auch mit  'kleineren'  Atari-Computern,  d.h.
  487. die alten Maschinen mit 512 kB funktionieren,  sofern  keine  Accessories  in-
  488. staliert sind!
  489.  
  490. 4.2) Rechnertypen
  491. -----------------
  492.  
  493. Das Programm sollte eigentlich mit allen Atari-Rechnern der ST-Familie (ST[E],
  494. Mega ST[E], etc.), TT und Falcon zurechtkommen!
  495.  
  496. 4.3) Auflösung
  497. --------------
  498.  
  499. Das Programm wurde im wesentlichen  für  die  hohe  ST-Auflösung  geschrieben,
  500. funktioniert aber auch in der mittleren Auflösung  (abgesehen  von  der  etwas
  501. verunstalteten Copyrightbox - dies wird hoffentlich bald geändert).
  502.  
  503.  
  504. 5) Bekannte Probleme
  505. ====================
  506.  
  507. 5.1) Abbrechen bei langsamen Standard-MIDI-Files
  508. ------------------------------------------------
  509.  
  510. Soll bei niedrigen Tempo die Abspielfunktion mit einem Tastendruck abgebrochen
  511. werden, kann es etwas länger dauern, bis die Abspielfunktion tatsächlich abge-
  512. brochen wird, also don't panic, wenn es etwas länger dauert.
  513.  
  514. 5.2) Probleme mit dem Key-Monitor
  515. ---------------------------------
  516.  
  517. Das Programm verweilt unter bestimmten Umständen bei der  Key-Monitor-Funktion
  518. in einer Endlosschleife:
  519.  
  520. Werden Tasten gedrückt oder losgelassen (d.h.  NOTE-ON's oder  Note-Off's  via
  521. MIDI zum Atari gesendet) verweilt das Programm in einer Schleife, bis ein Sta-
  522. tusbyte ungleich 0x80 .. 0x9f empfangen wird. Z.B. senden viele Keyboards wenn
  523. alle Tasten losgelassen werden, den Befehl ALL-NOTES-OFF, mit dem die Schleife
  524. verlassen wird.  Wird aber bevor ein solches Statusbyte  empfangen  wird  bei-
  525. spielsweise das Keyboard ausgeschaltet, so gibt es keine Möglichkeit mehr, die
  526. Schleife zu verlassen.  I.d.R.  senden Keyboards  den  Befehl  ACTIVE  SENSING
  527. (0xfe) alle 300 ms wenn keine anderen MIDI-Daten gesendet werden,  mit dem die
  528. Schleife verlassen wird.  Es ist aber möglich,  daß das Keyboard ausgeschaltet
  529. wird wenn sich die Programmausführung noch  innerhalb  der  Schleife  befindet
  530. (z.B.  wenn kurz zuvor eine Keyboard-Taste gedrückt und gedrückt gehalten wur-
  531. de), noch bevor die 300 ms verstrichen sind.
  532.  
  533. 5.3) Fehlende MIDI-THRU-Funktion
  534. --------------------------------
  535.  
  536. Das Programm besitzt keine MIDI-THRU-Funktion, und schon gar keine MIDI-MERGE-
  537. Funktion.  Bei Verwendung eines separaten MIDI-THRU-Programm (z.B.  Satellite,
  538. liegt u.a.  Cubase bei) kann es zu unvorhergesehenen Ergebnissen kommen,  wenn
  539. sich die von einem MIDI-Keyboard über MIDI-IN ankommenden Daten mit denen die-
  540. ses Programmes am MIDI-OUT-Ausgang mischen. Zumindest aber sollte das Keyboard
  541. auf einen anderen Kanal eingestellt werden, als den auf dem die Song-Daten ge-
  542. sendet werden (i.d.R. senden meine (einfachen) Songs auf Ch. 1).
  543.  
  544. Z.B.  sendet mein Keyboard immer  zusätzlich  ein  ALL-NOTES-OFF,  wenn  keine
  545. Tasten mehr gedrückt sind.  Dadurch werden dann auch die vom Programm gespiel-
  546. ten Noten abgeschnitten.
  547.  
  548.  
  549. 6) Sonstiges
  550. ============
  551.  
  552. 6.1) Werbung - Andere MIDI-Programme von mir
  553. --------------------------------------------
  554.  
  555.  - MidiKla4.APP - Zeigt die auf einem angeschlossen  MIDI-Keyboard  gedrückten
  556.    Tasten auf einem Bildschirmkeyboard an.
  557.  
  558.    Das Programm MidiKla4.APP ist der Key-Monitor des Piano-Players  als  sepa-
  559.    rates Programm,  funktioniert auch als Accessory,  zu finden auf  dem  Ftp-
  560.    Server der Uni-Erlangen/Nürnberg  ftp.uni-erlangen.de  -  Verzeichnis  pub/
  561.    atari/sound/...
  562.  
  563.  - Das Programm SMF_LOAD.PRG beinhaltet die im Piano-Player noch nicht  einge-
  564.    baute Analyse-Funktion.
  565.  
  566.  - GM_SLCTR.APP - Soundauswahlprogramm  für  General-MIDI  Musikmodule,  funk-
  567.    tioniert  auch  als  Accessory,  zu  finden  auf dem  Ftp-Server  der  Uni-
  568.    Erlangen/Nürnberg ftp.uni-erlangen.de - Verzeichnis pub/atari/sound/...
  569.  
  570.  - GM_03R_W.APP - Soundauswahlprogramm für KORG 03R/W.  (Funktioniert auch als
  571.    Accessory!)
  572.  
  573.  - SMF_PLAY.APP - A GEM-based-Standard-MIDI-File-Player.
  574.  
  575.    Dies ist im wesentlichen der Abspielalgorithmus dieses Programmes in  einem
  576.    separaten Programm, funktioniert auch als Accessory (nur nicht parallel zur
  577.    Hauptapplikation,  d.h. ein weiterarbeiten, während ein SMF abgespielt wird
  578.    ist nicht möglich!)
  579.  
  580.    Zu finden auf:  Ftp-server der Uni Paderborn:  ftp.uni-paderborn.de   unter
  581.    /atari/tools/sounds/midi/smf_play.lzh.
  582.  
  583.  - O3RWGMME.APP - General-MIDI-Multiset-Editor für Korg O3R/W:
  584.                   Erlaubt das Abspeichern von Multisets als Standard-MIDI-File
  585.                   Funktioniert auch als Accessory!
  586.  
  587. 6.2) Credits
  588. ------------
  589.  
  590.  - Das Programm wurde vollständig in der Programmiersprache C  geschrieben  --
  591.    mit Pure C (V. 1.1).
  592.  
  593.  - Die Resourcedatei wurde mit Interface erstellt.
  594.  
  595.  - Der Abspielalgorithmus basiert im wesentlichen auf dem von Steve  Goldthorp
  596.    im Juli '91 freigegebenen 'midi file interpreter for midiplay',  sowie  auf
  597.    die geänderte Version midiplay 0.5 von Piet van Oostrum.
  598.  
  599.    midiplay.zoo 0.5 ist z.B. auf dem niederländischen FTP-Server ftp.cs.ruu.nl
  600.    unter pub/MIDI/PROGRAMS/ATARI/midiplay.zoo zu finden, bzw. liegt als LHarc-
  601.    Archiv in einigen Mäusen herum.
  602.  
  603.  
  604. 6.3) Aufruf an Benutzer des Programmes
  605. --------------------------------------
  606.  
  607. Wer Interesse an den Programmsourcen hat (die sind allerdings nicht sehr  auf-
  608. regend) möge mir eine Diskette  und  einen  frankierten  Rückumschlag  senden.
  609. Evtl.  gibt's dann auch eine neuere Programmversion,  in der zumindest die bis
  610. dahin gefundenen Fehler behoben sein sollten, und ein paar weitere SMFs.
  611.  
  612. Wer eigene SMFs hat,  die mit dem Programm abgespielt werden können,  darf mir
  613. diese gerne zusenden (macht sowieso keiner!!!).
  614.  
  615. Ansonsten sind auch Spenden aller Art willkommen. (-> FAIRWARE)
  616. (Ach halt, mit Blutspenden kann ich momentan nicht viel anfangen -
  617. die sind z.B. beim Roten Kreuz besser aufgehoben!)
  618.  
  619. Anregungen für Verbesserungsmöglichkeiten,  weiteren Funktionen,  aufgetretene
  620. Fehler können/sollten mir mitgeteilt werden.  (Daß auch das niemand macht  ist
  621. mir natürlich bekannt!)
  622.  
  623.  
  624. 7) Nutzungs-, Verbreitungs- und sonstige Bestimmungen
  625. =====================================================
  626.  
  627. 7.1) Nutzungsbestimmungen
  628. -------------------------
  629.  
  630.   1) Das Programm/die Programme darf/dürfen von
  631.  
  632.       a) jedermann,
  633.  
  634.       b) jederfrau,
  635.  
  636.       c) sonstigen Lebewesen,  die sich unter 1 a) und 1 b) nicht angesprochen
  637.          fühlen (d.h.  also nicht nur die auf Kohlenstoff basierenden  Lebens-
  638.          formen, sondern auch alle anderen)
  639.  
  640.      benutzt werden.
  641.  
  642.   2) Das Programm/die Programme darf/dürfen von den unter  1)  genannten  Per-
  643.      sonen frei kopiert und weitergegeben werden (d.h.  von alle  PersonInnen/
  644.      Etwase),  soweit alle Dateien,  die in 'INHALT.TXT' angegeben sind  dabei
  645.      weitergegeben werden. Ausnahmen siehe unter 'Vertrieb'!
  646.  
  647.   3) Das Programm/die Programme und die beiliegenden Hilfstexte darf/dürfen in
  648.      keiner Weise verändert werden.
  649.  
  650. 7.2) Vertrieb
  651. -------------
  652.  
  653.   1) Der Verkauf des Programmes/der Programme ist unter keinen  Umständen  er-
  654.      laubt.
  655.  
  656.   2) Das Vertreiben des Programmes/der Programme in Mailboxen ist ausdrücklich
  657.      erwünscht,  sofern es sich um nicht-komerzielle Mailboxen handelt. Hierzu
  658.      ist auch das Packen des Programmes/der Programme  erlaubt,  sofern  dabei
  659.      alle Dateien, die in 'INHALT.TXT' angegeben sind weitergegeben werden.
  660.  
  661.      Der Vertrieb über kostenpflichtige  Mailboxsysteme,  'Channel  Videodat',
  662.      etc. ist nicht erlaubt, ebenso ist die Aufnahme des Programmes auf CD-ROM
  663.      ohne vorherige Absprache mit mir nicht gestattet.
  664.  
  665.   3) PD-Versender dürfen das Programm/die Programme in Ihre Serien  oder  Lie-
  666.      ferprogramme aufnehmen,  sofern der 'Kopierpreis' pro Diskette nicht mehr
  667.      als DM 5.- beträgt (einschl. der Diskette)!
  668.  
  669.      Ich erwarte allerdings eine kurze Mitteilung,  wenn jemand das  Programm/
  670.      die Programme aufnehmen will (z.B. Postkarte, email).
  671.  
  672.   4) Wenn das Programm/die Programme in eine MIDI-Programmsammlung (bzw.  eine
  673.      Zusammenstellung mehrerer MIDI-Programme zu einem Paket)  eines  PD-Händ-
  674.      lers aufgenommen werden soll,  so  ist  dafür  bei  mir  eine  gesonderte
  675.      Erlaubnis einzuholen!
  676.  
  677.   5) Gewerbliche Vertreiber von Sequenzer-Songs,  die das Programm mit diesen
  678.      Sequenzer-Songs  weitergeben wollen müssen ebenfalls eine gesonderte Er-
  679.      laubnis dafür bei mir einholen!
  680.  
  681. 7.3) Haftung
  682. ------------
  683.  
  684.   1) Für Schäden,  die durch durch den Einsatz dieses  Programmes/dieser  Pro-
  685.      gramme direkt oder indirekt an Hard-,  Soft- oder sonstiger -ware entste-
  686.      hen können,  sowie für alle sonstigen Schäden irgendwelcher Art (z.B. den
  687.      nächsten Börsencrash,  dem Erdbeben in LA oder das Aprilwetter) übernehme
  688.      ich keine Verantwortung.  Die Benutzung des Programmes erfolgt auf eigene
  689.      Gefahr!
  690.  
  691.   2) Die vollständige Fehlerfreiheit des  Programmes/der  Programme  kann  von
  692.      meiner Seite aus nicht garantiert werden.  -  Falls  ein  Benutzer  einen
  693.      Programmfehler finden sollte,  darf er ihn für sich behalten,  oder,  was
  694.      vielleicht etwas besser wäre, darf er mir auch mitgeteilt werden.
  695.  
  696. 7.4) Updates
  697. ------------
  698.  
  699.   1) Schriftliche Anfragen bei mir bzgl. neuer Versionen, bzw. neuer Programme
  700.      sind erlaubt (Anrufe werden  nicht  angenommen!!!),  werden  aber  i.d.R.
  701.      zeitlich verzögert beantwortet,  sofern ausreichend  Rückporto  beiliegt.
  702.      (Die Schreiben,  denen kein Rückporto beiliegt werden  gelesen,  gelocht,
  703.      abgeheftet und in den nächsten Papiercontainer befördert.) Emails  werden
  704.      i.d.R. nur während der Vorlesungszeit in jeweiligen Semester beantwortet,
  705.      da ich während der Semesterferien selten am Uni-Rechner anzutreffen  bin.
  706.      (Vielleicht schenkt mir bald jemand ein Modem, damit ich auch anderweitig
  707.      anzutreffen bin. ;-))
  708.  
  709.   2) Updates   der  Programme   (wenn's  denn  solche  geben  sollte)   werden
  710.      voraussichtlich    über   den   Ftp-Server    der   Uni-Erlangen/Nürnberg
  711.      (ftp.uni-erlangen.de - Verzeichnis pub/atari/sounds/...) unter die  Leute
  712.      gebracht, oder über PD-Versender sofern sich diese bei mir gemeldet haben
  713.      - s.o.
  714.  
  715.      Letzteres kann aber nicht garantiert  werden,  da  die  meine  Portokasse
  716.      immer an  gähnender  Leere  leidet,  weswegen  wahrscheinlich  nur  einer
  717.      (einige?) beliefert wird.  (Vielleicht werden neue/verbesserte  Programme
  718.      auch nur noch über Mailboxen verbreitet -  s.o.,  wenn  ich  endlich  ein
  719.      Modem besäße.)
  720.  
  721.      Wer mir einen ordnungsgemäß frankierten Rückumschlag  und  eine  Diskette
  722.      (bitte mit Public Domain-, Shareware-, Freeware-  oder  sonstiger -ware?)
  723.      zusendet, bekommt die jeweils aktuellste Version.
  724.      (Bitte das Versions-Datum aus der Info-Box mit angeben!)
  725.  
  726. 7.5) Warenzeichen
  727. -----------------
  728.  
  729. Die in dem Programm,  bzw.  der Dokumentation genannten  Soft-  und  Hardware-
  730. produkte,  Zeitschriftennamen bzw.  genannte Produktnamen Atari ST,  STE, Mega
  731. STE, TT, Falcon, Pure C, Interface, Mag!X, MultiTOS u.a. sind eingetragene Wa-
  732. renzeichen ihrer Eigentümer und als solche gesetzlich geschützt.
  733.  
  734. Aus  dem  Fehlen  einer  gesonderten Kennzeichnung kann also nicht geschlossen
  735. werden,  daß ein Name frei von Rechten Dritter ist.
  736.  
  737.  
  738. 8) Schlußwort
  739. =============
  740.  
  741. Wie üblich sind in diesem Text alle möglichen Fehler gut versteckt.
  742.  
  743. Dabei zählen:  Fehlende bzw.  zuviele Buchstaben jeweils 1 Punkt,  Buchstaben-
  744. verdreher  2  Punkte,   Komma-  und  sonstige  Satzzeichenfehler   3   Punkte,
  745. grammatikalische Fehler 4 Punkte und inhaltliche Fehler 5 Punkte. Falls jemand
  746. hier nicht aufgezählte Fehler findet darf sich endlich viele Punkte dafür  ge-
  747. ben.
  748.  
  749. Für die gefundenen Fehler sind die entsprechenden Punkte zu  vergeben  und  am
  750. Ende zusammenzuzählen.  Wer  über  100  Punkte  erreicht  darf  sich  für  die
  751. Deutschen Meisterschaften in Rechtschreibung anmelden.
  752.  
  753. Ha, ha, ha.
  754.  
  755.  
  756. 9) Literatur
  757. ============
  758.  
  759. [1] Kernighan/Ritchie: <Programmieren in C>. Hanser Verlag. 1990.
  760.  
  761. [2] Peter Kaminski:  <Die MIDI-Spezifikation>.  Erschienen in der Zeitschrift
  762.     Keyboards, MM-Musik-Media-Verlag, 1991.
  763.  
  764. [3] Dr. Bernd Enders/Wolfgang Klemme: <Das MIDI- und SOUND-Buch zum ATARI ST>
  765.     Markt & Technik Verlag, 1988.
  766.  
  767. [4] Dietmar Lorenz:  <MIDI-Software selber schreiben>.  GC Gunther Carstensen
  768.     Verlag, 1990.
  769.  
  770. [5] Richard Aicher: <Das MIDI Praxisbuch>. Signum Medien Verlag, 1987.
  771.  
  772. [6] <MIDI in C / Programmierer an die  Front>. 68000er ST-magazin 6/91 - 8/91
  773.     Markt & Technik.
  774.  
  775. [7] Siegfried Just:  <MIDITALK - Standard  MIDI-Files>.   ST-Computer   12/90.
  776.     Heim-Verlag, S. 144ff,
  777.  
  778. [8] Michael Cxelperger:  <Introducing Standard MIDI File>. Electronic Musican,
  779.     April 1989, S. 50ff
  780.  
  781. [9] <Standard-MIDI-File in C / Babylon  entschlüsselt>.   68000er   ST-magazin
  782.     10/91 - 11/91. Markt & Technik.
  783.  
  784. [10] Jankowski/Rabbich/Reschke:   <ATARI Profibuch ST-STE-TT>.   Sybex Verlag,
  785.      11. Auflage, 1992
  786.  
  787. [11] Dieter Geiß/Jürgen Geiß: <Vom Anfänger zum GEM-Profi>. Hüthig Buch Verlag
  788.      3. Auflage, 1992
  789.  
  790. [12] Kai Schwirzke:  <MIDI macht die Musik - Standard MIDI-File-Format>. c't -
  791.      magazin für computer technik 07/93, S.232ff Heise Verlag
  792.  
  793. [13] Justus Noll: <Musik-Programmierung>. Addison Wesley, 1994.
  794.  
  795. /* fin */
  796.